Skip to main content

Set Measurement Attribute for Elements

Elements that participate in the Sigmafine balance need to have a value calculated for each flow, transfer and inventory Element in the model. Examples of ways to get the Attribute value are as follows:

Measurement - Directly from a PI Point​

When a mass is stored in a PI Server as a tag value, you can use the PI Point Data Reference to retrieve its value. It is important to know what the data is that is being stored in PI. In order to import the correct value into the analysis case, you need to know whether the value is a continuous mass rate or a mass measurement and also what the unit of measure is for the value.

See the "PI Point Data Reference" section of the PI Server user guide for more information about configuration options.

Measurement – Calculated from a Volume​

To calculate a mass from a volume and density, use the Unit of Measure Data Reference to calculate the Mass. The volume and density Attributes have sources for their values, and you can use the Unit of Measure Data Reference (\ topic under Data Reference) to make this calculation.

It is important to determine that the volume used in this calculation is a Net Volume and not a Gross (Observed) volume. You can use the Gross to Net Volume calculation of the Sigmafine Data Reference to aid in this intermediate calculation. \See the topic under Data Reference in this Online manual.

Measurement – Calculated from a Level Gauge​

To calculate the mass from a level or gauge value measurement, use the Strapping Table or Polynomial Equation calculations in the Tank Volume from Gauge Data Reference. \See the topic under Data Reference.

Measurement – Determined in Self-Calculated Inventories​

If an inventory quantity is not measured and you want it to be calculated during the balance:

  1. Set the Attribute SelfCalculatingFlag to True in the element. Note that in Sigmafine 4.6, you cannot change this Attribute name from the default name of SelfCalculatingFlag.

  2. In the initial Case for an analysis series, adjust the value of the Reconciled Quantity in the Case results to the opening quantity for the inventory. The analysis rule uses the reconciled value Attribute in each prior Case for initialization. Therefore, the quantity must be set manually in the first case. To set the value of the quantity, create an adjustment in the attribute.

    As an alternative, the Sigmafine Balance Rule allows you to create an adjustment on the Attribute assigned to Opening Quantity if the analysis is configured to get the opening value from the current case.

This is the logic used to calculate quantity in self-calculated inventories.

When the Analysis Rule is set to use the previous Case for inventory opening quantity, the reconciled quantity is defined by this equation:

Reconciled Quantity = Reconciled Quantity Previous Case + Quantity from Flows In - Quantity from Flows Out

If values exist for both a measured quantity and a reconciled quantity, then the value for the measured quantity is used.

When the Analysis Rule is set to use the current Case for inventory opening quantity, the reconciled quantity is defined by this equation:

Reconciled Quantity = Opening Quantity Current Case + Quantity from Flows In - Quantity from Flows Out.